3D Graphics Programming with QuickDraw 3D 1.5.4

Managing Cursors

The 3D Viewer provides routines that you can use to ensure that the cursor is properly synchronized with the state of a viewer object.

Q3ViewerAdjustCursor

You can use the Q3ViewerAdjustCursor function to allow the 3D Viewer to adjust the cursor when it is inside a viewer object.

MAC OS VERSION



 
Boolean Q3ViewerAdjustCursor (

                     TQ3ViewerObject    theViewer,

                     Point              *pt);

WINDOWS VERSION



 
TQ3Boolean Q3WinViewerAdjustCursor (

                     TQ3ViewerObject    viewer,

                     long               x,

                     long               y );

PARAMETERS

theViewer: A viewer object.
pt: The location of the cursor, in the local coordinates of the window that contains the specified viewer object.
x: The horizontal position of the cursor, in the local coordinates of the window that contains the specified viewer object.
y: The vertical position of the cursor, in the local coordinates of the window that contains the specified viewer object..

DESCRIPTION

The Q3ViewerAdjustCursor function adjusts the cursor to whatever shape is appropriate when the cursor is located at the point specified by the pt parameter inside the viewer object specified by the theViewer parameter. You should call Q3ViewerAdjustCursor in response to a mouse-moved event or during your application's idle-time processing. Q3ViewerAdjustCursor returns a Boolean value that indicates whether the shape of the cursor was changed (TRUE ) or not (FALSE ).

Q3ViewerCursorChanged

You can use the Q3ViewerCursorChanged function to notify the 3D Viewer that you have changed the cursor.

MAC OS VERSION



 
OSErr Q3ViewerCursorChanged (TQ3ViewerObject theViewer);

WINDOWS VERSION



 
TQ3Status Q3WinViewerCursorChanged (TQ3ViewerObject viewer);

PARAMETER

theViewer: A viewer object.

DESCRIPTION

The Q3ViewerCursorChanged function notifies the 3D Viewer that you have changed the cursor while the viewer object specified by the theViewer parameter is active. You should call Q3ViewerCursorChanged whenever you change the cursor by calling the SetCursor routine.

SPECIAL CONSIDERATIONS

The Q3ViewerCursorChanged function is available only in versions 1.1 and later of the 3D Viewer.